docs: Document GtkBuildable changes in migration guide

https://gitlab.gnome.org/GNOME/gtk/-/issues/3191

diff --git a/docs/reference/gtk/migrating-3to4.md b/docs/reference/gtk/migrating-3to4.md
index 59800003b5229bc4b52e890343b15e368849795d..bae17df96f1452c32a0d9711d904913fe6d337b1 100644 (file)
--- a/docs/reference/gtk/migrating-3to4.md
+++ b/docs/reference/gtk/migrating-3to4.md
@@ -1041,6 +1041,13 @@ You can replace calls to gtk_dialog_run() by specifying that the
 %GTK_DIALOG_MODAL flag, and connecting to the #GtkDialog::response
 signal.
 
+### Stop using GtkBuildable API
+
+All the GtkBuildable API was made private, except for the
+getter function to retrieve the buildable ID. If you are
+using gtk_buildable_get_name() you should replace it with
+gtk_buildable_get_buildable_id().
+
 ## Changes to consider after the switch
 
 GTK 4 has a number of new features that you may want to take